home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 September / Macworld (1997-09).dmg / Shareware World / Utilities / Text Processing / Alpha / Help / Internet Config < prev    next >
Text File  |  1995-12-27  |  9KB  |  224 lines
  1.  
  2.  
  3.                     Internet Configuration System
  4.                         User Documentation
  5.  
  6.  
  7.  
  8. Click here for documentation on Alpha's interaction with Internet Config.
  9.  
  10. Introduction
  11.  
  12. The Internet Configuration System was designed to make your life easier by 
  13. reducing the number of times which you need to enter your Internet 
  14. preferences into the various preferences dialogs of all your Internet 
  15. applications.
  16.  
  17. For example, currently you need to enter your Email address into many 
  18. common Macintosh Internet applications, for example Eudora, NewsWatcher 
  19. and Anarchie. The goal of the system was to get each of these applications 
  20. to get this information from one common place and to give you a tool to 
  21. edit these common preferences.
  22.  
  23. It is important to realise that applications will have to be modified to 
  24. take advantage of the Internet Configuration System. It will take some 
  25. time for all applications to be revised and until then you will have to 
  26. enter your preferences in those applications in the traditional manner. 
  27. You can find a list of the applications that currently support Internet 
  28. Config in the FAQ (Frequently Asked Questions) document included in this 
  29. distribution.
  30.  
  31. Getting Started
  32.  
  33. System Requirements
  34.  
  35. The Internet Configuration system requires at least System 6 and works 
  36. best under System 7 or later. It does not require MacTCP and it makes 
  37. sense to install it even if you’re not directly connected to the Internet.
  38.  
  39. Quick Start
  40.  
  41. Run the Internet Config application. If it asks you whether you want to 
  42. install the Internet Config Extension, say yes. Click on each button in 
  43. the Main dialog in turn, enter appropriate preferences. [If you don’t 
  44. understand an item turn on Balloon Help or look it up in the reference 
  45. section at the end of this document.]  Save and quit.
  46.  
  47. It is important to realise that you don’t have to set every preference.  
  48. For example, if you don’t use WAIS then there’s no need to set your WAIS 
  49. Gateway preference.
  50.  
  51. Parts of the System
  52.  
  53. At the user level, the system contains 3 important parts:
  54.  
  55. o Internet Config application
  56. o Internet Config Extension
  57. o the Internet Preferences preferences file
  58.  
  59. The most important is the Internet Config application. When you run this 
  60. application it creates and installs the Internet Config Extension and 
  61. creates a default Internet Preferences file.
  62.  
  63. For the programmer there is a separate distribution that contains all the 
  64. files needed to make an Internet Config aware program.
  65.  
  66. Internet Configuration Application Reference
  67.  
  68. The Internet Configuration application works much like any other Macintosh 
  69. application. The basic document for the application is a Internet 
  70. Preferences preference file.
  71.  
  72. Unlike most Macintosh application, when you launch the ICApp it does not 
  73. create a new untitled document. Instead it opens the Internet Preferences 
  74. file in your preferences folder (creating it if it isn’t there). This is 
  75. useful because, unless you’re doing something strange, you need never use 
  76. the standard document features (New, Open, Save, etc). Instead all you 
  77. need to do is launch the application, modify your preferences and then 
  78. quit with saving.
  79.  
  80. Menus
  81.  
  82. The following commands are available on the  menu:
  83.  
  84. About Internet Config…
  85.  
  86. This opens the about box. Do not bother looking for magical Easter Eggs; 
  87. we were much too busy to mess with this sort of thing.
  88.  
  89. The following commands are available on the File menu:
  90.  
  91. New
  92. Open…
  93. Open Internet Preferences
  94. Close
  95. Save
  96. Save as…
  97. Quit
  98.  
  99. These commands work as you would expect in a normal Macintosh application, 
  100. with one exception. The application can only have one preferences file 
  101. open at any point in time so when you open a new preferences file, by Open 
  102. or New, the previous one is automatically closed.  The Open Internet 
  103. Preferences command opens the default set of Internet Preferences (in your 
  104. Preferences folder), which is useful if you accidentally close the window.
  105.  
  106. The Edit menu is used for editing text.
  107.  
  108. The Window menu allows you to open or bring to front any of the 
  109. configuration dialogs.
  110.  
  111. The help menu (on the right hand side of the menu bar) lets you turn on 
  112. Balloon Help. The application has full Balloon Help support.
  113.  
  114. Dialogs
  115.  
  116. The Main dialog is opened whenever you open a preferences file. It has 8 
  117. buttons (with cutesy colour icons) that let you open other dialogs 
  118.  
  119. The Personal dialog lets you edit all sorts of preferences related to your 
  120. person. These include:
  121.  
  122. o Real Name — your real name, as used by news and mail
  123. o Organization — the company etc that you work for, as used by news
  124. o Quote String — the string used to preceed quoted text, as used by news 
  125. and mail
  126. o Signature — a short piece of pithy text added to the end of your mail 
  127. messages and news posting, as used by news and mail
  128. o Plan — as used by finger servers
  129.  
  130. The Email dialog lets you edit preferences related to Email. These include:
  131.  
  132. o Email Address — address to which you want replies to your mail sent
  133. o Mail Account — account from which you wish you mail to be fetched
  134. o Mail Password — password for the above
  135. o Mail Host — host to which to forward mail (normally the same machine as 
  136. the one that has your mail account)
  137. o Mail Headers — any extra headers you want inserted in your outgoing mail
  138.  
  139. The News dialog lets you edit preferences related to News. These include:
  140.  
  141. o News Username — most systems let you read news without one
  142. o News Password — most systems let ou read news without one
  143. o NNTP Host — machine from which to fetch news
  144. o News Headers — any extra headers you want inserted in your news postings
  145.  
  146. The File Transfer dialog lets you edit preferences related to the transfer 
  147. of files (except file types, which have their own dialog). These include:
  148.  
  149. o Archie Server — your preferred Archie server
  150. o Info-Mac Server — your preferred Info-Mac mirror
  151. o UMich Server — your preferred UMich mirror
  152. o Download Folder — the place where you want new files to appear
  153.  
  154. Archie is a protocol for searching archive sites looking for files. There 
  155. are a number of Archie servers around the world. In theory these should 
  156. all be the same but sometimes it’s useful to use one in preference to 
  157. another. 
  158.  
  159. Info-Mac and UMich are two big archives of Macintosh software. They are 
  160. often very busy and won’t let you on. To get around this you can get files 
  161. from other machines that mirror these archives. Some software will use the 
  162. preferences here to automatically route requests to your preferred mirror.
  163.  
  164. The Other Services dialog is a collection of preferences that didn’t fit 
  165. in anywhere else. These include:
  166.  
  167. o Ph Host — your preferred Ph server (a standard machine name)
  168. o Finger Host — your default finger server
  169. o Whois Host — your default whois server
  170. o Telnet Host — the default machine for telnet connections
  171. o FTP Host — the default machine for FTP connections
  172. o Gopher Host — your ‘root’ gopher server (a standard machine name)
  173. o WWW Home Page — your WWW home page (a URL)
  174. o WAIS Gateway — your WAIS gateway (a standard machine name)
  175. o LDAP — Stuff related to X.500, see your X.500 docs for more details
  176.  
  177. The Fonts dialog lets you set your preferred List, Screen and Printer 
  178. font.  The List font is used in summary listings, such as mailbox 
  179. summaries or FTP directory listings, while the Screen font is used 
  180. whenever non-proportional text is display, such as mail message or news 
  181. posting windows.   The Printer font is used when non-proportional text is 
  182. printed.
  183.  
  184. The File Types dialog lets you view and edit the table that is used to set 
  185. the Macintosh file type and creator of incoming files based on their 
  186. extension. If you don’t understand this dialog then please don’t worry. 
  187. We’ve done our best to set up appropriate defaults.
  188.  
  189. The Helpers dialog lets you view and edit the table that is used to 
  190. determine which application to run when a specific URL is accessed. For 
  191. example, ICeTEe uses this table to determine what application to run when 
  192. you command click a URL.
  193.  
  194. System 6 Notes
  195.  
  196. All of the Internet Configuration documentation assumes that you are 
  197. running under System 7. Under System 6 some things are slightly different 
  198. from what is stated in the documentation. The most important thing is the 
  199. placement of the files. Under System 6 the Internet Config Extension and 
  200. the Internet Preferences file are always placed in the System Folder. Also 
  201. some non-critical parts of the system may not work under System 6.
  202.  
  203. The entire Internet Configuration system has been tested under System 6 
  204. and should work happily. Having said that, you are warned that the system 
  205. has had a lot more testing under System 7 than System 6 and there may be 
  206. System 6 specific problems still lurking. If you find any, please report 
  207. them to us.
  208.  
  209. Credits
  210.  
  211. The official support address for Internet Config is 
  212. <internet-config@share.com>.  If you find a bug in IC then please forward 
  213. details to that address.  If you want to discuss IC in general then I 
  214. suggest you host that discussion on the comp.sys.mac.comm newsgroup.
  215.  
  216. The Internet Configuration System was written by Quinn “The Eskimo!” and 
  217. Peter N Lewis over a period of too many late nights and weekends. Certain 
  218. important chunks of code were contributed by Marcus Jager and Stuart 
  219. Cheshire. We would like to thank all of those on the Internet Config 
  220. mailing list and all of the developers who have adopted the system.
  221.  
  222. The entire Internet Config system is public domain and can be 
  223. redistributed without restriction.
  224.